home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 019a / rhodes.zip / WARRIOR.TXT < prev   
Text File  |  1991-11-17  |  29KB  |  820 lines
  1.  
  2.                                   Rhodes Warrior
  3.                                    User's Manual
  4.                                  Table of Contents
  5.  
  6.  
  7.  
  8.  
  9.  
  10.   Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  11.  
  12.   Overview / Design Philosophy  . . . . . . . . . . . . . . . . . . . . . . .  2
  13.  
  14.   Installation  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  15.  
  16.   General Instructions  . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  17.  
  18.   Main Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  19.  
  20.   Editing Patches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  21.  
  22.   Utility Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  23.  
  24.   Play Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  25.  
  26.   Sending Libraries From The Command-Line . . . . . . . . . . . . . . . . . .  8
  27.  
  28.   Appendix A  Command-Line Parameters . . . . . . . . . . . . . . . . . . . .  9
  29.   Appendix B  Problems? . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  30.   Appendix C  Technical Information . . . . . . . . . . . . . . . . . . . . . 11
  31.   Appendix D  Play/R  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  32.   Appendix E  Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . 13
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.   ______________________________________________________________________________
  63.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  64.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved             1
  65.                            OVERVIEW / DESIGN PHILOSOPHY
  66.  
  67.   The Rhodes Warrior  is a complete IBM- and  MPU401-compatible patch editor and
  68.   librarian  program for  Roland's Rhodes  MK-80 MIDI  keyboard/controller.   It
  69.   works equally well in single- and multi-program environments.
  70.  
  71.   Multi-program   environments  (e.g.,  DESQview   and  Windows)  place  special
  72.   constraints  on  the design  of  MIDI programs.    Like  current (and  future)
  73.   versions  of popular sequencers, the Rhodes Warrior uses the MIDI interface in
  74.   UART mode  (also called "dumb" mode).   In this way its  window can peacefully
  75.   coexist with windows running sequencers and/or other UART-mode applications.
  76.  
  77.   The Rhodes Warrior plays your  MIDI files as you edit ─  you hear your changes
  78.   instantly in the context of your  own musical projects!  It saves its  data in
  79.   standard binary  format (also called "MIDIEX format") so it is compatible with
  80.   bulk loaders and other utilities.  Finally, it gives you complete control over
  81.   both patch- and controller-oriented parameters.
  82.  
  83.   The Rhodes Warrior is designed for one-way MIDI communication (Computer OUT =>
  84.   MK-80 IN) to  ensure data integrity.   Data can't be lost  when another window
  85.   transmits extraneous data and/or switches the interface into "smart" mode.
  86.  
  87.   This manual describes how to modify, save  and audition the various parameters
  88.   within  the MK-80.   It  does  not describe  what  these parameters  do.   For
  89.   example, it describes how to turn Chorus on and off, but it doesn't state what
  90.   effect that  has on the  sound nor why  you may want  that effect.   The MK-80
  91.   Owner's Manual does a good job explaining these features.
  92.  
  93.  
  94.                                    INSTALLATION
  95.  
  96.   Quick Start
  97.  
  98.     Connect  a MIDI cable from  the computer's MIDI Out  to the MK-80's MIDI In.
  99.     Copy all files into a new directory and change to that directory.  Enter one
  100.     of these four commands and press <Enter>:
  101.  
  102.       W         runs on channel 1 (MK-80's default).
  103.  
  104.       W  /C:9   runs on channel 9 (change "9" to any MIDI channel from 1 to 16).
  105.  
  106.       W  /C:0   runs  with MIDI  output  completely disabled ─  "demo" mode  for
  107.                 computers without a MIDI interface.
  108.  
  109.       W  /?     displays a  help screen explaining  all of the  Rhodes Warrior's
  110.                 command-line options.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.   ______________________________________________________________________________
  126.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  127.                    Contact me via CompuServe Mail ─ #72461,3345                2
  128.                              INSTALLATION (continued)
  129.  
  130.   Detailed Instructions
  131.  
  132.     WARRIOR.EXE  is  the   actual  program  file.     WARRIOR.REG  contains  the
  133.     registration  information.  Both  files must be  in the same  directory.  As
  134.     implied, WARRIOR.REG is not  necessary nor included in the  unregistered BBS
  135.     version.
  136.  
  137.     PLAYR.EXE is the MIDI file player program.  See the PLAY/R appendix for more
  138.     details concerning command-line options, etc.
  139.  
  140.     Two data files  are shipped with  the Rhodes Warrior.   COLDBOOT.M80 is  the
  141.     data  that exists in  the MK-80 when  shipped from Roland.   IMPORT.M80 is a
  142.     slightly  modified  version  of  COLDBOOT.M80;  it  is   provided  to  allow
  143.     experimenting with the IMPORT feature.  Note that you can always restore the
  144.     MK-80's  factory data  by performing  the cold  boot procedure  described on
  145.     page 37 of the MK-80 Owner's Manual.
  146.  
  147.     Data files (*.M80) can be in a separate directory (recommended).  To run the
  148.     Rhodes Warrior when  the data and the  program are in  separate directories,
  149.     type the following commands:
  150.  
  151.       D:                       change to the drive  the data resides on (assumed
  152.                                as D: for this example)
  153.  
  154.       CD \SYSEX                change  to the  directory  the  data  resides  in
  155.                                (assumed as \SYSEX for this example)
  156.  
  157.       C:\MTOOLS\PLAYR ─a64     type the fully-qualified path to  PLAYR.EXE (MIDI
  158.                                file  player)  (assumed  as  C:\MTOOLS  for  this
  159.                                example).   Note  that this command  is optional;
  160.                                you  don't need it if you do not wish to audition
  161.                                patches.  See the  PLAY/R appendix for the actual
  162.                                command-line options.
  163.  
  164.       C:\MK-80\WARRIOR /C:9    type  the  fully-qualified  path  to  WARRIOR.EXE
  165.                                (assumed as C:\MK-80 for this example)
  166.  
  167.       Note:  You can put these commands in a batch file (see W.BAT) or your menu
  168.       system.   You  can  also edit  the  included RW-PIF.DVP  file  for use  in
  169.       DESQview 2.x.
  170.  
  171.   At least one data file is  always required; because of the 1-way communication
  172.   discussed in OVERVIEW /  DESIGN PHILOSOPHY,  the program loads  its data  from
  173.   disk,  not  from the  MK-80.    I suggest  leaving  COLDBOOT.M80  in the  data
  174.   directory at all times to avoid problems.  Even better, flag the file as read-
  175.   only with DOS's ATTRIB +R COLDBOOT.M80 command.
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.   ______________________________________________________________________________
  189.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  190.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved             3
  191.                                GENERAL INSTRUCTIONS
  192.  
  193.   Select  menu options by cursoring  (arrows, <Home>, <End>,  <PgUp>, <PgDn>) to
  194.   the  desired choice  and pressing  <Enter>.   Back out  one level  by pressing
  195.   <Escape>.
  196.  
  197.   Pressing <Escape> from  the MAIN MENU will QUIT the program.   However, if you
  198.   issue a command that will wipe out a library you haven't yet saved (i.e., LOAD
  199.   or  QUIT), the program  will tell you  so and ask  if you're sure  you want to
  200.   continue.  Press Y (for "Yes") to continue the operation.  Press any other key
  201.   (for "No") to redisplay the MAIN MENU and position the cursor bar on SAVE.
  202.  
  203.   On pop-up lists (e.g.,  the files available to  LOAD and the UTILITY and  PLAY
  204.   menus),  mice are  supported.   The Rhodes  Warrior will  detect if  the mouse
  205.   driver is loaded and display a block mouse cursor when the mouse is available.
  206.   Position the cursor on the desired item and press the left-mouse button.
  207.  
  208.   Certain pop-up screens cannot display all of the  available choices within the
  209.   allotted  window.  In this case,  there will be up and  down arrows within the
  210.   right border  of the window indicating  "scroll for more choices".   Cursor as
  211.   appropriate or  position the  mouse cursor on  the appropriate scroll  bar and
  212.   hold the left button down.
  213.  
  214.   The  Rhodes Warrior  will  not accept  invalid data  (e.g., asterisks  in file
  215.   names, patch  number "89")  nor data past  the end  of the field  (e.g., nine-
  216.   character  filenames).   During any edit,  you may backspace  to change data ─
  217.   nothing becomes  "official" until  you press  <Enter>.   Before then, you  may
  218.   always  change  your  mind ─  pressing  <Escape>   will  redisplay  the  prior
  219.   (unchanged) value.
  220.  
  221.   By design, the Rhodes Warrior saves and retrieves patch library  data files to
  222.   and from the  current directory  only.   This was  done to  simplify the  user
  223.   interface and  minimize configuration headaches.  If you wish to store data in
  224.   multiple directories, see INSTALLATION for more information.
  225.  
  226.   Whenever  the Rhodes Warrior is  transmitting system exclusive  MIDI data, two
  227.   beamed  sixteenth notes will display in the  lower right corner of the screen.
  228.   This  data is  always  transmitted on  the  MIDI channel  you  specify on  the
  229.   command-line.  This transmission temporarily pauses the MIDI file player (when
  230.   playing) so sysex and channel messages don't collide with each other.
  231.  
  232.   The PLAY MENU will pop-up over any menu screen by pressing the space bar.  See
  233.   PLAY MENU for more information.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.   ______________________________________________________________________________
  252.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  253.                    Contact me via CompuServe Mail ─ #72461,3345                4
  254.                                      MAIN MENU
  255.  
  256.   The MAIN MENU has six options ─ LOAD, CHOOSE, EDIT, RENAME, SAVE, and UTILITY.
  257.   Except for some UTILITY options, you must first LOAD a  file before proceeding
  258.   further.
  259.  
  260.   LOAD pops-up a list of  data files in your  current directory.  Cursor to  the
  261.   file you wish to  load and press <Enter>.   This (a) loads the data  file into
  262.   memory,  (b) sends  the  data to  the MK-80,  (c) chooses  patch "11"  as your
  263.   current work-in-process patch, and (d) program  changes to patch "11".   Press
  264.   <Escape> to exit without loading a data file.
  265.  
  266.   CHOOSE displays the 64 patches from the library currently in memory.  Select a
  267.   patch to edit by typing  its tone type (1-8)  followed by its sequence  number
  268.   (1-8) within that tone type.  This chooses that patch as your current work-in-
  269.   process patch and  program changes to  that patch number.   Press <Escape>  to
  270.   exit without choosing a new patch.
  271.  
  272.   EDIT displays a block diagram  of the MK-80's internal layout and  asks you to
  273.   select  a  parameter  block  for  editing.    See  EDITING  PATCHES  for  more
  274.   information.
  275.  
  276.   RENAME redisplays the current patch  name and allows you to rename it.   Valid
  277.   characters are  a-z, A-Z, 0-9, space  and period.  A  patch name can  be up to
  278.   twelve  characters long.   Type  in  the new  name and  press  <Enter>.   This
  279.   displays  the new name  on the MK-80's  LCD.   Press <Escape> to  exit without
  280.   renaming the patch.
  281.  
  282.   SAVE allows  you to  save your  patch library using  the CURRENT  filename, an
  283.   EXISTING filename  or a NEW  filename.  SAVE starts  by asking if  you want to
  284.   save the file using the current name (i.e., overwrite the  file you're working
  285.   with).  Press  Y (for "Yes")  to save the  file and  redisplay the MAIN  MENU.
  286.   Press any other key  (for "No") to display a list of existing files.  If you'd
  287.   like  to overwrite  one  of these,  cursor  to it  and press  <Enter>.   Press
  288.   <Escape> to prompt for  a new name.  Type  in the new data filename  and press
  289.   <Enter> (don't type  the .M80 file extension (the  Rhodes Warrior will prevent
  290.   you from doing so)).  Press <Escape> to exit without saving the file.
  291.  
  292.   UTILITY  pops-up  a list  of  utility  options.   See  UTILITY  MENU for  more
  293.   information.
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.   ______________________________________________________________________________
  315.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  316.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved             5
  317.                                   EDITING PATCHES
  318.  
  319.   The Edit Menu  displays five parameter blocks which  correspond roughly to the
  320.   MK-80's front panel ─ TONE (which also contains the Stretch Tuning parameter),
  321.   EFFECTS, EQ/VOLUME (separated from EFFECTS to reduce screen clutter), INTERNAL
  322.   CONTROLLER and  EXTERNAL CONTROLLER.   Cursor to  a parameter block  and press
  323.   <Enter> to display its edit screen.
  324.  
  325.   Within  the individual  edit screens,  the parameter  prompts generally  mimic
  326.   those found on the MK-80's  LCD.  Cursor up or down to the  parameter you wish
  327.   to  change and  press  <Enter> to  select  it.   The  edit  interface is  very
  328.   straightforward once you  understand the  three types of  data and  respective
  329.   procedures (please experiment here):
  330.  
  331.     (a) two-value toggles (e.g., Chorus Mode, Tremolo  On/Off) ─ <Enter> toggles
  332.     back and forth between the two available values.
  333.  
  334.     (b)  qualitative  numbers / non-numeric  parameters ─  these are  parameters
  335.     whose numeric values are either:
  336.  
  337.       (i) not ordinally  related (e.g., Velocity Curve 2 is not "more" velocity-
  338.       sensitive than Curve 1), or
  339.  
  340.       (ii)  not assignable to numbers (e.g., Internal Controller 3 sends Tremolo
  341.       data instead of Punch data).
  342.  
  343.     Selecting  one  of these  parameters pops-up  a  list of  the  valid values.
  344.     Cursor/mouse to  the desired choice and  press <Enter>/left button.   If you
  345.     don't want to change the value, press <Escape>/right  button.  These numbers
  346.     have an  attempt at "describing" the qualitative aspect so you don't have to
  347.     reference the MK-80's manual.  For example, Velocity Curve 5 is described as
  348.     the algebraic addition of a linear function plus an inverse sine wave.
  349.  
  350.     (c)  quantitative numbers  (e.g.,  Punch) ─  these  values do  have  ordinal
  351.     relationships (e.g., a  Punch value of 32 is "punchier"  than 31).  Pressing
  352.     <Enter> asks  you for a new value within the valid range (e.g., "Enter a new
  353.     value between 0 and 32").  Enter the number and press <Enter>.  If you don't
  354.     want   to  change  the  value,  press  <Escape>.     Although  Mid  Freq  is
  355.     quantitative, only  101 discrete values are  available.  Thus, it  is edited
  356.     like the pop-ups in (b) above.
  357.  
  358.   Each valid update sends the new MIDI data immediately to the MK-80.
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.   ______________________________________________________________________________
  378.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  379.                    Contact me via CompuServe Mail ─ #72461,3345                6
  380.                                    UTILITY MENU
  381.  
  382.   The UTILITY MENU has three options ─ COPY, IMPORT, and RESET.
  383.  
  384.   COPY  copies patches within the current library  from one location to another.
  385.   It displays the current patch  names and asks you for the  "source" patch (the
  386.   patch you want to copy).   Upon selecting the source, COPY asks you  to select
  387.   the "destination"  patch (where you want the copy  to go).  Upon selecting the
  388.   destination,  COPY (a) copies the  data from source  to destination, (b) sends
  389.   the destination patch's new parameter data  to the MK-80, (c) program  changes
  390.   to  the destination  patch number  and (d)  redisplays the  new patch  library
  391.   names.  Continue copying patches until you wish to quit by pressing <Escape>.
  392.  
  393.   IMPORT functions like COPY except the "source" patches come from a second data
  394.   library.   IMPORT starts by asking you to select the import data library (like
  395.   LOAD).  IMPORT  then displays the patches  in the source library  and asks you
  396.   which  source  patch  to  import.    It  then  displays  the  patches  in  the
  397.   "destination" library (your current, work-in-process library) and asks you for
  398.   a destination  number.  Continue importing  patches until you wish  to quit by
  399.   pressing <Escape>.
  400.  
  401.   RESET puts the interface back into UART mode.  If it cannot do so, it displays
  402.   an error  message to that  effect.   This option is  only necessary  in multi-
  403.   program  environments when another  window resets  the interface  into "smart"
  404.   mode.
  405.  
  406.  
  407.                                      PLAY MENU
  408.  
  409.   The  PLAY MENU  has three options  (more will  follow) ─ LOAD,  PLAY/PAUSE and
  410.   REWIND.  If a song is not yet  loaded, the PLAY MENU goes directly to the LOAD
  411.   option.  Access the PLAY MENU from any other menu by pressing the space bar.
  412.  
  413.   LOAD  pops-up a list of  files that match the  filespec specified with the /M:
  414.   command-line parameter (if /M: is not specified, it defaults to  a list of the
  415.   *.MID files in  your current directory).  Cursor to the  file you wish to load
  416.   and press <Enter>.  The Rhodes Warrior  loads this file into memory and starts
  417.   playing it.  LOAD displays an error  message if there is a problem loading the
  418.   file; it then reloads,  rewinds and replays the  prior file if one was  loaded
  419.   and if it can do so.
  420.  
  421.   PLAY/PAUSE functions like a tape recorder ─ it starts a stopped song and stops
  422.   a playing  song.  In other  words, it toggles the  player on and off.   If the
  423.   file is  playing, the menu  option states  "Pause"; conversely, if  paused, it
  424.   states "Play".
  425.  
  426.   REWIND "rewinds" the player to the beginning of the current song.
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.   ______________________________________________________________________________
  441.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  442.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved             7
  443.                       SENDING LIBRARIES FROM THE COMMAND-LINE
  444.  
  445.   The Rhodes  Warrior can also send MK-80 patch library data files directly from
  446.   the  command line.  To do so,  specify the /S: command-line parameter followed
  447.   by the name  of a patch library  file.  You  can optionally specify a  channel
  448.   number.
  449.  
  450.   These files do not have to be in the current directory.  For example,  if your
  451.   current  directory is  D:\MIDI\SYSEX and  it contains COLDBOOT.M80,  either of
  452.   these  two commands  will send  the file  to the MK-80  on channel 9  and exit
  453.   immediately to DOS:
  454.  
  455.     Warrior /C:9 /S:ColdBoot.M80
  456.  
  457.     Warrior /S:D:\MIDI\SYSEX\ColdBoot.M80 /C:9
  458.  
  459.   This feature is  similar to other bulk loaders with  the additional capability
  460.   to redirect MK-80 data to any MIDI channel.
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.   ______________________________________________________________________________
  504.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  505.                    Contact me via CompuServe Mail ─ #72461,3345                8
  506.                                     Appendix A
  507.                               COMMAND-LINE PARAMETERS
  508.  
  509.  
  510.  
  511.   The  Rhodes Warrior has  several optional command-line  parameters to maximize
  512.   its  flexibility.  Note that parameters (a) are not case-sensitive (e.g., /c:1
  513.   is the same as /C:1), (b) must be separated by at least one space (i.e., there
  514.   must be a space before  each "/" character), and (c) may not  contain imbedded
  515.   spaces (e.g., /C:   14 is invalid).
  516.  
  517.  
  518.             Warrior   /B   /C:n   /M:smf   /P   /Q   /S:file   /W   /?
  519.  
  520.  
  521.   /B        Display  black and white.  This option  is most useful for portables
  522.             and other computers whose "colors" appear illegible.
  523.  
  524.   /C:n      Use MIDI channel "n" (defaults to 1).  /C:0 disables  sysex output ─
  525.             "demo" mode when no MPU401 is attached.  /C:0 overrides /S:file.
  526.  
  527.   /M:smf    Load standard MIDI files using this  filespec.  Defaults to *.MID in
  528.             the  current  directory if  not specified.    Note that  the Warrior
  529.             handles pathnames like DOS does ─ e.g., if you're in D:\MIDI and the
  530.             song  files are *.MFF in  D:\MIDI\Jams, each of  these three options
  531.             will work: /M:Jams\*.MFF, /M:\MIDI\Jams\*.MFF, or /M:D:.\Jams\*.MFF.
  532.  
  533.   /P        Play WARRIOR.MID immediately if found.  Not yet implemented.
  534.  
  535.   /Q        Quick start ─ skip startup screens (registered version only).
  536.  
  537.   /S:file   Send the patch library "file" to the MK-80 and exit to DOS.
  538.  
  539.   /W        Wait for a keystroke after a terminating error.  This option is most
  540.             useful  for multi-program environments  which might  otherwise close
  541.             the Rhodes Warrior's window leaving you wondering why it didn't run.
  542.             When using a batch file, you may instead want to branch based on the
  543.             returned ERRORLEVEL (see the TECHNICAL INFORMATION appendix).
  544.  
  545.   /?        Displays  a DOS 5.0-style help screen.  This parameter overrides all
  546.             others.
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.   ______________________________________________________________________________
  567.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  568.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved             9
  569.                                     Appendix B
  570.                                      PROBLEMS?
  571.  
  572.  
  573.  
  574.   MIDI
  575.  
  576.     If your  edits do not  update the MK-80,  it's probably because  (1) another
  577.     window within your  multi-program environment has reset  your MIDI interface
  578.     into "smart" mode, (2) your MK-80 is set-up to ignore system exclusive data,
  579.     or (3) the channels on the Rhodes Warrior and your MK-80 don't match.  Don't
  580.     worry ─  your data is  safe.  To  correct (1), RESET  the interface from the
  581.     UTILITY MENU.   To correct (2),  follow the instructions  on page 29 of  the
  582.     MK-80 Owner's Manual.  Finally, to correct (3), change the receiving channel
  583.     on  the MK-80  (also on page 29)  and/or specify the  correct Rhodes Warrior
  584.     channel via the /C:n command-line option.
  585.  
  586.  
  587.   Error Stops Program Immediately
  588.  
  589.     Five errors  are fatal enough to  halt the Rhodes Warrior  before it starts.
  590.     They are easy to fix as shown here:
  591.  
  592.     1 ─  Command-line syntax  error ─ a  "spelling" error  on the  command line.
  593.     Imbedded  spaces are  not allowed  within any  parameter (e.g.,  /C:   01 is
  594.     invalid);  at least one space  is required between  parameters (i.e., before
  595.     each "/").  Run WARRIOR /? if you want command-line help.
  596.  
  597.     2 ─  Non-numeric MIDI  channel  requested ─ another  "spelling" error.   All
  598.     characters after the /C: parameter must be digits 0-9.
  599.  
  600.     3 ─ Invalid MIDI channel requested ─ you've requested a channel greater than
  601.     16.
  602.  
  603.     11 ─ MIDI interface  not initializing ─  most likely, this  means you  don't
  604.     have an MPU401-compatible MIDI interface installed.  You can run the Warrior
  605.     with  the /C:0  option.   If  running Play/R,  you may  need  to use  its -n
  606.     command-line  option  (see  the PLAY/R  appendix).    Finally,  I have  also
  607.     received this error message when using  my modem in another DESQview window,
  608.     however.   Ending the communications  program, re-running the Warrior and/or
  609.     cold booting the computer will solve this problem.
  610.  
  611.     21 ─ Requested patch library file not found ─ the file you tried  to send to
  612.     the  MK-80  could not  be  located.   Check  your  spelling  and try  again.
  613.     Remember to include the  ".M80" file extension and specify the  directory if
  614.     the file is not in the default directory.
  615.  
  616.     Note to DOS gurus: see the TECHNICAL INFORMATION appendix for information on
  617.     processing these errors within a batch file.
  618.  
  619.  
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.   ______________________________________________________________________________
  630.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  631.                    Contact me via CompuServe Mail ─ #72461,3345               10
  632.                                     Appendix C
  633.                                TECHNICAL INFORMATION
  634.  
  635.  
  636.  
  637.   System Requirements: Any IBM-compatible personal  computer, DOS 3.0 or  higher
  638.   and 300K free RAM (Play/R  needs an additional 60K  of RAM plus the MIDI  file
  639.   size).  For  MIDI communication,  you'll also need  an MPU401-compatible  MIDI
  640.   interface using the standard I/O address 330h and (of course!) a Rhodes MK-80.
  641.  
  642.   Because this is a  character-based program that detects the  graphics adapter,
  643.   any 80-column monitor will work.  And like other character-based programs, its
  644.   display improves going from CGA to EGA to VGA.
  645.  
  646.   Terminating errors  display an informative message on the middle of the screen
  647.   (see the PROBLEMS? appendix).  They also return the displayed  error number to
  648.   DOS and  can be checked within a  batch file using the  IF ERRORLEVEL command.
  649.   See  your  DOS manual  for more  details if  you're  interested in  using this
  650.   capability.
  651.  
  652.   Do not redirect  WARRIOR.EXE's output (i.e., don't use the ">" symbol anywhere
  653.   on  the  command-line).   Some  screens  will  not  display fully  when  using
  654.   redirection.  This will change in a future version.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.   ______________________________________________________________________________
  693.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  694.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved            11
  695.                                     Appendix D
  696.                                       PLAY/R
  697.  
  698.  
  699.  
  700.   Play/R,  the standard MIDI  file player, is  actually a separate  program.  As
  701.   described in both the ACKNOWLEDGMENTS appendix and the  MTOOLS.TXT file, it is
  702.   integrated into the  Rhodes Warrior so you can audition  sounds in the context
  703.   of your own musical projects.  You simply load and play any standard MIDI file
  704.   so you can immediately hear the effects of your edits.
  705.  
  706.  
  707.   Command-line options:        PlayR   -aNN   -dMPU:I:330   -n
  708.  
  709.     -aNN means "allocate NN KB of memory" for MIDI file storage.  The default is
  710.     -a24 (24 kilobytes); the maximum is -a64.
  711.  
  712.     -dMPU:I:330 means the MIDI interface is using IRQ I (instead of the standard
  713.     IRQ 2) and I/O address 330h.  Don't use change this option unless necessary.
  714.     Note that WARRIOR.EXE won't function on an I/O address other than 330h.
  715.  
  716.     -n means don't disable IRQ  9 when using IRQ 2.  You may  have to experiment
  717.     as to whether  or not you need this  option.  My MIDI card  (Voyetra OP4000)
  718.     needs this option; you probably won't.
  719.  
  720.     W.BAT's Play/R command-line is:  PLAYR -a64 -dMPU:2:330
  721.  
  722.  
  723.   Notes
  724.  
  725.     The maximum path  length for a Play/R  file is 40 bytes.   Longer file names
  726.     will return a "file not found" error message upon LOAD.
  727.  
  728.     Play/R handles MIDI files up to 16 tracks.  All tracks numbered greater than
  729.     16 are ignored during playback.
  730.  
  731.     The Rhodes Warrior unloads Play/R from memory upon exiting.
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.   ______________________________________________________________________________
  756.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  757.                    Contact me via CompuServe Mail ─ #72461,3345               12
  758.                                     Appendix E
  759.                                   ACKNOWLEDGMENTS
  760.  
  761.  
  762.  
  763.   C Programming for MIDI by Jim Conger.  Copyright 1988 by M&T Publishing.  This
  764.   is an excellent book for programmers new to C and/or MIDI.
  765.  
  766.   Music Quest Programmer's Toolkit ─  Copyright 1987, 1990 by Music  Quest, Inc.
  767.   This package  contains many  routines for the  MIDI programmer; I'm  using the
  768.   simpler I/O-oriented features.
  769.  
  770.   Play/R ─  Copyright 1991  by  Kevin Weiner.    Play/R is  actually a  separate
  771.   terminate and stay resident (TSR) program ─ the Rhodes Warrior by itself won't
  772.   play standard  MIDI files.    Play/R is  part  of MidiTools  (copyright  Kevin
  773.   Weiner, 1991), an  excellent set  of useful shareware  MIDI utilities.   Kevin
  774.   wrote  an application  programming interface  to allow  other programs  to tap
  775.   Play/R's  power.  Thus,  playing MIDI files is  now completely integrated into
  776.   the Rhodes Warrior.
  777.  
  778.   MidiTools has powerful  capabilities and  is highly recommended.   And  Play/R
  779.   itself has several features not yet  used within the Rhodes Warrior, including
  780.   the ability to remap channels within a MIDI file.
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.   ______________________________________________________________________________
  819.                Rhodes Warrior ─ MK-80 Editor/Librarian ─ Version 1.1
  820.                 Copyright 1991 by Jeff Cazel ─ All Rights Reserved            13